Release 10.1A: OpenEdge Development:
Debugging and Troubleshooting

LOG-MANAGER system handle attributes and methods

The LOG-MANAGER system handle attributes and methods provide a limited set of capabilities to access the logging settings for the current OpenEdge session during run-time.

Table 5–2 lists the function of each LOG-MANAGER system handle attribute.

Table 5–2: LOG-MANAGER system handle attributes 

Attribute	Access	Function
ENTRY-TYPES-LIST	Readable	Returns a character string containing a comma-separated list of all valid entry types for the current OpenEdge environment.
LOG-ENTRY-TYPES	Readable/Writable	Specifies a comma-separated list of one or more types of log entries to write to the log file.
LOGFILE-NAME	Readable/Writable	Specifies the name of log file OpenEdge uses to log messages and 4GL stack trace information.
LOGGING-LEVEL	Readable/Writable	Specifies the level at which log entries are written to the log file.
LOG-THRESHOLD	Readable	Returns the file size threshold of log files. When the current log file becomes equal to or greater than the specified size, OpenEdge renames and saves the log file and creates a new log file.
NUM-LOG-FILES	Readable	Returns the number of rolled over log files to keep on disk at any one time, for OpenEdge session, including the current log file.
TYPE	Readable	Returns the type of handle (for all system handles, “PSEUDO-WIDGET”).

Table 5–3 lists the function of each LOG-MANAGER system handle method.

Table 5–3: LOG-MANAGER system handle methods 

Method	Function
CLEAR-LOG( )	Clears all messages existing in the current client log file and leaves the file open for writing.
CLOSE-LOG( )	Stops an interactive or batch client from writing messages to the current log file, and closes the log file.
WRITE-MESSAGE( )	Writes user messages to the current log file.

For more information on the LOG-MANAGER system handle or its attributes and methods, see the LOG-MANAGER system handle reference entry in OpenEdge Development: Progress 4GL Reference .